PATH  Mac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Icon Services and Utilities
>
Obtaining and Using Icons With Icon Services

   

GetIconRefOwners

Provides the current reference count for an IconRef .

pascal OSErr GetIconRefOwners(
                     IconRef iconRef,
                     UInt16*owners);

iconRef
A pointer to a value of typeIconRef whose reference count you wish to obtain.

owners
A pointer to a value of type UInt16 . On return, this value represents the current reference count.

function result
A result code. See Icon Services Result Codes for a description of possible return values.
DISCUSSION
When an IconRef 's reference count reaches 0, all memory allocated for the IconRef is marked as disposable. Any subsequent attempt to use the IconRef returns a result code of -2580 (invalidIconRefErr).


© 1999 Apple Computer, Inc. – (Last Updated 03 Dec 99)